home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / installed_progs / gfx / daggex / docs / clients / xserver.doc < prev    next >
Encoding:
Text File  |  1994-06-04  |  19.6 KB  |  595 lines
  1.  
  2.  
  3.  
  4. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      Xserver - X Window System server
  10.  
  11. SYNOPSIS
  12.      X [:displaynumber] [-option ...] [ttyname]
  13.  
  14. DESCRIPTION
  15.      _X is the generic name for the X Window System server.  It is
  16.      frequently a link or a copy of the appropriate server binary
  17.      for driving the most  frequently  used  server  on  a  given
  18.      machine.
  19.  
  20. STARTING THE SERVER
  21.      The server is usually started from  the  X  Display  Manager
  22.      program _x_d_m.  This utility is run from the system boot files
  23.      and takes care of keeping the server running, prompting  for
  24.      usernames  and passwords, and starting up the user sessions.
  25.      It is easily configured for sites that wish to provide nice,
  26.      consistent  interfaces  for novice users (loading convenient
  27.      sets of resources, starting up a window manager, clock,  and
  28.      nice selection of terminal emulator windows).
  29.  
  30.      Installations that run more  than  one  window  system  will
  31.      still  need  to use the _x_i_n_i_t utility.  However, _x_i_n_i_t is to
  32.      be considered a tool for building startup scripts and is not
  33.      intended  for  use  by  end  users.  Site administrators are
  34.      strongly urged to use _x_d_m, or  build  other  interfaces  for
  35.      novice users.
  36.  
  37.      When the X server starts up, it takes over the display.   If
  38.      you  are  running  on  a  workstation  whose  console is the
  39.      display, you cannot log into the console while the server is
  40.      running.
  41.  
  42. NETWORK CONNECTIONS
  43.      The X server supports connections made using  the  following
  44.      reliable byte-streams:
  45.  
  46.      _T_C_P/_I_P
  47.          The server listens  on  port  6000+_n,  where  _n  is  the
  48.          display number.
  49.  
  50.      _U_n_i_x _D_o_m_a_i_n
  51.          The X server uses /_t_m_p/._X_1_1-_u_n_i_x/_Xn as the filename  for
  52.          the socket, where _n is the display number.
  53.  
  54.      _D_E_C_n_e_t
  55.          The server responds to connections to object _X$_Xn, where
  56.          _n  is  the display number.  This is not supported in all
  57.          environments.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. X Version 11         Last change: Release 5                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  71.  
  72.  
  73.  
  74. OPTIONS
  75.      All of the X  servers  accept  the  following  command  line
  76.      options:
  77.  
  78.      -a _n_u_m_b_e_r
  79.              sets pointer acceleration (i.e.  the  ratio  of  how
  80.              much is reported to how much the user actually moved
  81.              the pointer).
  82.  
  83.      -auth _a_u_t_h_o_r_i_z_a_t_i_o_n-_f_i_l_e
  84.              Specifies a file  which  contains  a  collection  of
  85.              authorization  records  used to authenticate access.
  86.              See also the _x_d_m and _X_s_e_c_u_r_i_t_y manual pages.
  87.  
  88.      bc      disables certain kinds of error  checking,  for  bug
  89.              compatibility  with previous releases (e.g., to work
  90.              around bugs in  R2  and  R3  xterms  and  toolkits).
  91.              Deprecated.
  92.  
  93.      -bs     disables backing store support on all screens.
  94.  
  95.      -c      turns off key-click.
  96.  
  97.      c _v_o_l_u_m_e
  98.              sets key-click volume (allowable range: 0-100).
  99.  
  100.      -cc _c_l_a_s_s
  101.              sets the visual class for the root window  of  color
  102.              screens.   The class numbers are as specified in the
  103.              X protocol.  Not obeyed by all servers.
  104.  
  105.      -co _f_i_l_e_n_a_m_e
  106.              sets name of RGB color database.
  107.  
  108.      -dpi _r_e_s_o_l_u_t_i_o_n
  109.              sets the resolution of the screen, in dots per inch.
  110.              To  be  used  when  the  server cannot determine the
  111.              screen size from the hardware.
  112.  
  113.      -f _v_o_l_u_m_e
  114.              sets feep (bell) volume (allowable range: 0-100).
  115.  
  116.      -fc _c_u_r_s_o_r_F_o_n_t
  117.              sets default cursor font.
  118.  
  119.      -fn _f_o_n_t
  120.              sets the default font.
  121.  
  122.      -fp _f_o_n_t_P_a_t_h
  123.              sets the search path for  fonts.   This  path  is  a
  124.              comma  separated  list  of  directories  which the X
  125.              server searches for font databases.
  126.  
  127.  
  128.  
  129. X Version 11         Last change: Release 5                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  137.  
  138.  
  139.  
  140.      -help   prints a usage message.
  141.  
  142.      -I      causes all remaining command line  arguments  to  be
  143.              ignored.
  144.  
  145.      -ld _k_i_l_o_b_y_t_e_s
  146.              sets the data space  limit  of  the  server  to  the
  147.              specified  number  of  kilobytes.   A  value of zero
  148.              makes the data  size  as  large  as  possible.   The
  149.              default  value  of  -1  leaves  the data space limit
  150.              unchanged.  This option  is  not  available  in  all
  151.              operating systems.
  152.  
  153.      -lf _f_i_l_e_s
  154.              sets the number-of-open-files limit of the server to
  155.              the  specified  number.   A  value is zero makes the
  156.              limit as large as possible.  The default value of -1
  157.              leaves  the  limit  unchanged.   This  option is not
  158.              available in all operating systems.
  159.  
  160.      -ls _k_i_l_o_b_y_t_e_s
  161.              sets the stack space limit  of  the  server  to  the
  162.              specified  number  of  kilobytes.   A  value of zero
  163.              makes the stack size  as  large  as  possible.   The
  164.              default  value  of  -1  leaves the stack space limit
  165.              unchanged.  This option  is  not  available  in  all
  166.              operating systems.
  167.  
  168.      -logo   turns on the X Window System  logo  display  in  the
  169.              screen-saver.   There  is currently no way to change
  170.              this from a client.
  171.  
  172.      nologo  turns off the X Window System logo  display  in  the
  173.              screen-saver.   There  is currently no way to change
  174.              this from a client.
  175.  
  176.      -p _m_i_n_u_t_e_s
  177.              sets screen-saver pattern cycle time in minutes.
  178.  
  179.      -r      turns off auto-repeat.
  180.  
  181.      r       turns on auto-repeat.
  182.  
  183.      -s _m_i_n_u_t_e_s
  184.              sets screen-saver timeout time in minutes.
  185.  
  186.      -su     disables save under support on all screens.
  187.  
  188.      -t _n_u_m_b_e_r
  189.              sets pointer acceleration threshold in pixels  (i.e.
  190.              after  how  many  pixels pointer acceleration should
  191.              take effect).
  192.  
  193.  
  194.  
  195. X Version 11         Last change: Release 5                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  203.  
  204.  
  205.  
  206.      -to _s_e_c_o_n_d_s
  207.              sets default connection timeout in seconds.
  208.  
  209.      tty_x_x   ignored, for servers started the ancient  way  (from
  210.              init).
  211.  
  212.      v       sets video-off screen-saver preference.
  213.  
  214.      -v      sets video-on screen-saver preference.
  215.  
  216.      -wm     forces the default backing-store of all  windows  to
  217.              be   WhenMapped;   a  cheap  trick  way  of  getting
  218.              backing-store to apply to all windows.
  219.  
  220.      -x _e_x_t_e_n_s_i_o_n
  221.              loads the specified extension  at  init.   Not  sup-
  222.              ported in most implementations.
  223.  
  224.      You can also have the X server connect to _x_d_m  using  XDMCP.
  225.      Although  this  is not typically useful as it does not allow
  226.      _x_d_m to manage the server process, it can be  used  to  debug
  227.      XDMCP implementations, and serves as a sample implementation
  228.      of the server side of XDMCP.  For more information  on  this
  229.      protocol, see the _X _D_i_s_p_l_a_y _M_a_n_a_g_e_r _C_o_n_t_r_o_l _P_r_o_t_o_c_o_l specif-
  230.      ication.  The following  options  control  the  behavior  of
  231.      XDMCP.
  232.  
  233.      -query _h_o_s_t-_n_a_m_e
  234.              Enable XDMCP and send Query packets to the specified
  235.              host.
  236.  
  237.      -broadcast
  238.              Enable XDMCP and broadcast BroadcastQuery packets to
  239.              the  network.   The first responding display manager
  240.              will be chosen for the session.
  241.  
  242.      -indirect _h_o_s_t-_n_a_m_e
  243.              Enable XDMCP and send IndirectQuery packets  to  the
  244.              specified host.
  245.  
  246.      -port _p_o_r_t-_n_u_m
  247.              Use an alternate  port  number  for  XDMCP  packets.
  248.              Must  be  specified before any -query, -broadcast or
  249.              -indirect options.
  250.  
  251.      -once   Normally, the server keeps  starting  sessions,  one
  252.              after  the other.  This option makes the server exit
  253.              after the first session is over.
  254.  
  255.      -class _d_i_s_p_l_a_y-_c_l_a_s_s
  256.              XDMCP has an additional display  qualifier  used  in
  257.              resource  lookup for display-specific options.  This
  258.  
  259.  
  260.  
  261. X Version 11         Last change: Release 5                     4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  269.  
  270.  
  271.  
  272.              option sets that  value,  by  default  it  is  "MIT-
  273.              Unspecified" (not a very useful value).
  274.  
  275.      -cookie _x_d_m-_a_u_t_h-_b_i_t_s
  276.              When testing XDM-AUTHENTICATION-1, a private key  is
  277.              shared  between  the  server  and the manager.  This
  278.              option sets the value of that private data (not that
  279.              it is very private, being on the command line!).
  280.  
  281.      -displayID _d_i_s_p_l_a_y-_i_d
  282.              Yet another XDMCP specific value,  this  one  allows
  283.              the display manager to identify each display so that
  284.              it can locate the shared key.
  285.  
  286.      Many servers also have device-specific command line options.
  287.      See  the  manual  pages  for the individual servers for more
  288.      details.
  289.  
  290. SECURITY
  291.      The X server implements a simplistic authorization protocol,
  292.      MIT-MAGIC-COOKIE-1  which  uses  data  private to authorized
  293.      clients and the server.  This is a rather trivial scheme; if
  294.      the  client  passes  authorization data which is the same as
  295.      the server has, it is allowed access.  This scheme is  worse
  296.      than  the  host-based  access control mechanisms in environ-
  297.      ments with unsecure networks as it allows any host  to  con-
  298.      nect,  given that it has discovered the private key.  But in
  299.      many environments, this level of security is better than the
  300.      host-based  scheme  as  it  allows  access  control per-user
  301.      instead of per-host.
  302.  
  303.      In addition, the server provides  support  for  a  DES-based
  304.      authorization  scheme,  XDM-AUTHORIZATION-1,  which  is more
  305.      secure (given a secure key  distribution  mechanism).   This
  306.      authorization scheme can be used in conjunction with XDMCP's
  307.      authentication scheme (XDM-AUTHENTICATION-1)  or  in  isola-
  308.      tion.
  309.  
  310.      The authorization data is passed to the server in a  private
  311.      file  named  with  the -auth command line option.  Each time
  312.      the server is about to accept the first connection  after  a
  313.      reset  (or when the server is starting), it reads this file.
  314.      If this file contains any authorization records,  the  local
  315.      host  is not automatically allowed access to the server, and
  316.      only clients which send one  of  the  authorization  records
  317.      contained  in  the  file in the connection setup information
  318.      will be allowed access.  See  the  _X_a_u  manual  page  for  a
  319.      description  of the binary format of this file.  Maintenance
  320.      of this file, and distribution of  its  contents  to  remote
  321.      sites for use there is left as an exercise for the reader.
  322.  
  323.  
  324.  
  325.  
  326.  
  327. X Version 11         Last change: Release 5                     5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  335.  
  336.  
  337.  
  338.      The server also provides support for SUN-DES-1, using  Sun's
  339.      Secure RPC.  It involves encrypting data with the X server's
  340.      public key.  See the _X_s_e_c_u_r_i_t_y manual page for more informa-
  341.      tion.
  342.  
  343.      The X server also uses a host-based access control list  for
  344.      deciding  whether  or not to accept connections from clients
  345.      on a particular machine.  If no other authorization  mechan-
  346.      ism  is being used, this list initially consists of the host
  347.      on which the server is  running  as  well  as  any  machines
  348.      listed  in  the  file  /_e_t_c/_Xn._h_o_s_t_s, where n is the display
  349.      number of the server.  Each line of the file should  contain
  350.      either  an  Internet  hostname  (e.g. expo.lcs.mit.edu) or a
  351.      DECnet hostname  in  double  colon  format  (e.g.  hydra::).
  352.      There  should be no leading or trailing spaces on any lines.
  353.      For example:
  354.  
  355.              joesworkstation
  356.              corporate.company.com
  357.              star::
  358.              bigcpu::
  359.  
  360.      Users can add or remove hosts from this list and  enable  or
  361.      disable access control using the _x_h_o_s_t command from the same
  362.      machine as the server.
  363.  
  364.      The X protocol intrinsically does not  have  any  notion  of
  365.      window  operation  permissions  or place any restrictions on
  366.      what a client can do; if a program can connect to a display,
  367.      it  has  full  run  of  the  screen.  Sites that have better
  368.      authentication and authorization systems (such as  Kerberos)
  369.      might wish to make use of the hooks in the libraries and the
  370.      server to provide additional security models.
  371.  
  372. SIGNALS
  373.      The X server attaches special meaning to the following  sig-
  374.      nals:
  375.  
  376.      _S_I_G_H_U_P  This signal causes the server to close all  existing
  377.              connections,  free  all  resources,  and restore all
  378.              defaults.  It is sent by the display  manager  when-
  379.              ever  the  main  user's main application (usually an
  380.              _x_t_e_r_m or window manager) exits to force  the  server
  381.              to clean up and prepare for the next user.
  382.  
  383.      _S_I_G_T_E_R_M This signal causes the server to exit cleanly.
  384.  
  385.      _S_I_G_U_S_R_1 This signal is used quite differently from either of
  386.              the above.  When the server starts, it checks to see
  387.              if it has inherited SIGUSR1 as  SIG_IGN  instead  of
  388.              the usual SIG_DFL.  In this case, the server sends a
  389.              SIGUSR1 to its parent process after it  has  set  up
  390.  
  391.  
  392.  
  393. X Version 11         Last change: Release 5                     6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  401.  
  402.  
  403.  
  404.              the  various  connection  schemes.   _X_d_m  uses  this
  405.              feature to recognize when connecting to  the  server
  406.              is possible.
  407.  
  408. FONTS
  409.      Fonts are usually stored as individual files in directories.
  410.      The  X  server can obtain fonts from directories and/or from
  411.      font servers.  The list of directories and font servers  the
  412.      X  server  uses  when trying to open a font is controlled by
  413.      the _f_o_n_t _p_a_t_h.  Although most sites will choose to have  the
  414.      X  server start up with the appropriate font path (using the
  415.      -_f_p option mentioned above), it can be overridden using  the
  416.      _x_s_e_t program.
  417.  
  418.      The default font path for the X server contains four  direc-
  419.      tories:
  420.  
  421.      /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_m_i_s_c
  422.              This directory contains  many  miscellaneous  bitmap
  423.              fonts that are useful on all systems.  It contains a
  424.              family of fixed-width fonts, a family of fixed-width
  425.              fonts  from Dale Schumacher, several Kana fonts from
  426.              Sony Corporation, two JIS Kanji  fonts,  two  Hangul
  427.              fonts from Daewoo Electronics, two Hebrew fonts from
  428.              Joseph Friedman, the standard cursor font, two  cur-
  429.              sor  fonts  from  Digital Equipment Corporation, and
  430.              cursor and glyph fonts from  Sun  Microsystems.   It
  431.              also  has  various  font name aliases for the fonts,
  432.              including fixed and variable.
  433.  
  434.      /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_S_p_e_e_d_o
  435.              This   directory   contains   outline   fonts    for
  436.              Bitstream's  Speedo rasterizer.  A single font face,
  437.              in normal, bold, italic, and bold  italic,  is  pro-
  438.              vided, contributed by Bitstream, Inc.
  439.  
  440.      /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_7_5_d_p_i
  441.              This directory contains bitmap fonts contributed  by
  442.              Adobe  Systems, Inc., Digital Equipment Corporation,
  443.              Bitstream,  Inc.,  Bigelow  and  Holmes,   and   Sun
  444.              Microsystems,  Inc.   for 75 dots per inch displays.
  445.              An  integrated  selection  of  sizes,  styles,   and
  446.              weights are provided for each family.
  447.  
  448.      /_u_s_r/_l_i_b/_X_1_1/_f_o_n_t_s/_1_0_0_d_p_i
  449.              This directory contains 100 dots per  inch  versions
  450.              of some of the fonts in the _7_5_d_p_i directory.
  451.  
  452.      Font databases are created by running the _m_k_f_o_n_t_d_i_r  program
  453.      in  the  directory  containing  the compiled versions of the
  454.      fonts (the ._p_c_f files).   Whenever  fonts  are  added  to  a
  455.      directory,  _m_k_f_o_n_t_d_i_r should be rerun so that the server can
  456.  
  457.  
  458.  
  459. X Version 11         Last change: Release 5                     7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  467.  
  468.  
  469.  
  470.      find the new fonts.  If _m_k_f_o_n_t_d_i_r is  not  run,  the  server
  471.      will not be able to find any fonts in the directory.
  472.  
  473. DIAGNOSTICS
  474.      Too numerous to list them all.  If run from _i_n_i_t(_8),  errors
  475.      are typically logged in the file /_u_s_r/_a_d_m/_X*_m_s_g_s,
  476.  
  477. FILES
  478.      /etc/X*.hosts                 Initial access control list
  479.  
  480. /usr/lib/X11/fonts/100dpi
  481.      /usr/lib/X11/fonts/misc,                /usr/lib/X11/fonts/75dpi,
  482.                                    Bitmap font directories
  483.  
  484.      /usr/lib/X11/fonts/Speedo     Outline font directories
  485.  
  486.      /usr/lib/X11/fonts/PEX        PEX font directories
  487.  
  488.      /usr/lib/X11/rgb.txt          Color database
  489.  
  490.      /tmp/.X11-unix/X*             Unix domain socket
  491.  
  492.      /usr/adm/X*msgs               Error log file
  493.  
  494. SEE ALSO
  495.      X(1), bdftopcf(1), mkfontdir(1),  fs(1),  xauth(1),  xdm(1),
  496.      xhost(1), xinit(1), xset(1), xsetroot(1), xterm(1), Xdec(1),
  497.      Xibm(1), XmacII(1), Xmips(1), Xqdss(1),  Xqvss(1),  Xsun(1),
  498.      Xtek(1), X386(1) _X _W_i_n_d_o_w _S_y_s_t_e_m _P_r_o_t_o_c_o_l, _D_e_f_i_n_i_t_i_o_n _o_f _t_h_e
  499.      _P_o_r_t_i_n_g _L_a_y_e_r _f_o_r _t_h_e _X _v_1_1 _S_a_m_p_l_e  _S_e_r_v_e_r,  _S_t_r_a_t_e_g_i_e_s  _f_o_r
  500.      _P_o_r_t_i_n_g _t_h_e _X _v_1_1 _S_a_m_p_l_e _S_e_r_v_e_r, _G_o_d_z_i_l_l_a'_s _G_u_i_d_e _t_o _P_o_r_t_i_n_g
  501.      _t_h_e _X _V_1_1 _S_a_m_p_l_e _S_e_r_v_e_r
  502.  
  503. BUGS
  504.      The option syntax is inconsistent with itself and _x_s_e_t(_1).
  505.  
  506.      The acceleration option should take a numerator and a denom-
  507.      inator like the protocol.
  508.  
  509.      If _X dies before its clients, new clients won't be  able  to
  510.      connect  until  all  existing  connections  have  their  TCP
  511.      TIME_WAIT timers expire.
  512.  
  513.      The color database is missing a large number of colors.
  514.  
  515. COPYRIGHT
  516.      Copyright 1984, 1985, 1986, 1987,  1988,  1989,  1990,  1991
  517.      Massachusetts Institute of Technology.
  518.      See _X(_1) for a full statement of rights and permissions.
  519.  
  520. AUTHORS
  521.      The  sample  server  was   originally   written   by   Susan
  522.  
  523.  
  524.  
  525. X Version 11         Last change: Release 5                     8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. XSERVER(1)               USER COMMANDS                 XSERVER(1)
  533.  
  534.  
  535.  
  536.      Angebranndt,  Raymond  Drewry, Philip Karlton, and Todd New-
  537.      man, from Digital Equipment Corporation, with support from a
  538.      large  cast.   It  has  since  been extensively rewritten by
  539.      Keith Packard and Bob Scheifler, from MIT.
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591. X Version 11         Last change: Release 5                     9
  592.  
  593.  
  594.  
  595.